Inside Macintosh: QuickDraw GX Objects /

Chapter 8 - Tag Objects / Tag Objects Reference

Functions / Creating and Manipulating Tag Objects

GXDisposeTag

You can use the GXDisposeTag function to release a reference to a tag object.

void GXDisposeTag(gxTag target);

target

A reference to the tag object to dispose of.

DESCRIPTION

The GXDisposeTag function decrements the owner count of the tag object specified by the target parameter. GXDisposeTag deletes the tag object and releases any memory used by it if the owner count goes to zero.

SPECIAL CONSIDERATIONS

If you attempt to alter a tag object associated with a screen view device, this function posts a tag_access_restricted error.

ERRORS, WARNINGS, AND NOTICES

Errors
tag_is_nil
cannot_dispose_locked_tag	(debugging version)
tag_access_restricted	(debugging version)

SEE ALSO

Owner counts for tag objects are discussed in the section "Copying, Comparing, and Cloning Tag Objects" beginning on page 8-9, and in the section "Manipulating a Tag Object's Owner Count" beginning on page 8-11.

To examine the owner count of a tag object, use the GXGetTagOwners function, described on page 8-18. To increment the owner count of a tag, use the GXCloneTag function, described on page 8-17.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help